一下为使用hexo框架搭建github博客的简要步骤
<!-- more -->
1.安装
前提是必须先安装 Node.js,
再安装hexo:npm install hexo -g
2.在本地网页文件夹下,进入命令行.
hexo init <folder>
3.创建自己的文章
hexo new "文章名"
或者hexo n "文章名"
4.生成网站
输入hexo generate
或者 hexo g
5.开启本地服务器。默认监听4000端口
hexo server
浏览器输入:http://localhost:4000
即可预览本地的网页。
// 改变需要监听端口 hexo s -p 3000
6.编辑配置文件_config.yml (在网站项目的根目录下)
如果没有以下的内容,就添加。注意冒号后面有空格。
deploy:
type: github
repo: http://github.com/用户名/用户名.github.io.git
branch: master
title: 村里有个小芳是姑娘
subtitle:
description:
author: fernandozhaxi
language: zh-Hans
timezone:
7.部署:
输入: hexo deploy
或者 hexo d
就可以完成我们的博客搭建了。
以后要更新博客,只需要以下步骤:hexo new "Hello World"
hexo g
hexo d
过程中可能会遇到一些问题:
比如:
- 1.Not found git
解决办法: npm install hexo-deployer-git --save 即可
- 2.Please tell me who you are
输入git邮箱和用户名即可。
如:git config --global user.email “你的git邮箱”
git config --global user.name “你的git用户名”
- 3.the file will have be replaced by CRLF in ....
解决办法:git config --global core.autocrlf false - 4.Unable to access “https:github.......”
解决办法: 把https,改成http - 5.部署时提示 “Not a git repository”的异常信息
解决办法: 删掉.deploy目录.
8.下载next主题(也可以用git clone命令,但是我这里太慢,就直接下载zip包):
https://github.com/iissnan/hexo-theme-next
- 1.在本地网站项目的theme文件夹下建立一个next的文件夹,将下载的zip包解压,把里面的文件复制到next文件夹中。
如图:![图片描述][1]
9.切换主题
打开项目的根目录中的_config.yml
文件,找到theme字段,改为:theme:next
输入hexo clean
来清除hexo缓存,再输入:hexo server
开启本地服务器,我们可以通过浏览器输入:http://localhost:4000/
测试访问是否切换成功。
10.设置主题信息
- a.切换布局:
打开主题目录中的_config.yml
文件,找到如下字段三种布局任意选一个设置即可。
#scheme: Muse
#scheme: Mist
scheme: Pisces
- b.设置菜单:
打开主题目录中的_config.yml
文件,找到menu字段,设置如下:
menu:
home: /
archives: /archives
#about: /about
#categories: /categories
tags: /tags
#commonweal: /404.html
-
c.菜单项显示文本:设置菜单项的显示文本。在第一步中设置的菜单的名称并不直接用于界面上的展示。Hexo 在生成的时候将使用 这个名称查找对应的语言翻译,并提取显示文本。这些翻译文本放置在 NexT 主题目录下的 languages/{language}.yml ({language} 为你所使用的语言)。以简体中文为例,若你需要添加一个菜单项,比如 something。那么就需要修改简体中文对应的翻译文件 languages/zh-Hans.yml,在 menu 字段下添加一项:
menu: home: 首页 archives: 归档 categories: 分类 tags: 标签 about: 关于 search: 搜索 commonweal: 公益404 something: 有料
-
d.设置侧栏,设置侧栏的位置,修改 sidebar.position 的值,支持的选项有:
`` left - 靠左放置`` `` right - 靠右放置``
- e.设置头像,新增字段 avatar, 值设置成头像的链接地址。其中,头像的链接地址可以是:互联网 URI:
http://example.com/avtar.png
本地文件:放置在 source/images/ 目录下配置为:avatar: /images/avatar.png
- f.设置多说评论,
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。